home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 126-150 / disk_147 / sys / default / readme < prev    next >
Text File  |  1992-05-06  |  5KB  |  113 lines
  1.             MG Termcap Terminal Driver
  2.  
  3. The termcap library needs to know where to get the terminal type and
  4. termcap capibilities file from.  UNIX and Os9/68k users should
  5.  
  6.     setenv TERM term-type
  7.  
  8. to their terminal type, and
  9.  
  10.     setenv TERMCAP termcap-file
  11.  
  12. if they are using a non-standard termcap file.  VMS users should see
  13. [.SYS.VMS]AAAREADME.1ST for information on how to define the logical
  14. names TERM and ETC to point to the termcap definition file.  Users of
  15. other operating systems should do the aproprate thing.  For an example
  16. of a termcap file, UNIX users may look in /etc/termcap, Os9/68k users
  17. may look at /dd/sys/termcap (if present), and VMS users should see the
  18. file [.SYS.VMS.TERMCAP]TERMCAP. 
  19.  
  20. MG requires that certain terminal capabilities exist in the specified
  21. termcap entry.  The "cm" (cursor motion) capability *must* be
  22. available to use MG.  (Yes, it is possible to fake cm with some other
  23. capibilities, but MG doesn't try.) If your terminal is one that uses
  24. control characters in the paramater portion of the "cm" string, the
  25. "up" and "bc" capabilites may also be needed.  (See your termlib
  26. documentation for when this is so.)
  27.  
  28. If the following capabilities are available, they are used.  The AL
  29. and DL sequences are not totally standard, but having them improves
  30. the performance of the editor, since it doesn't have to redraw the
  31. screen to delete a line.  They should not be used if they need control
  32. characters as paramaters.
  33.  
  34.     cd    -- clear display
  35.     ce    -- clear to end of line
  36.  
  37.     al    -- insert 1 line
  38.     dl    -- delete 1 line
  39.  
  40.     AL    -- insert multiple lines (note capitalization)
  41.     DL    -- delete multiple lines (note capitalization)
  42.  
  43.     ti    -- cursor movement initialization string
  44.     te    -- cursor movement end string
  45.  
  46. The cs capability is not as standard as some of the other
  47. capibilities, but is used by MG when available.  It is used to define
  48. a "scrolling region", which defines a window within the screen where
  49. all the action takes place.  A newline character at the bottom of this
  50. area scrolls the rest of the text in the area up one line, just like
  51. the normal screen; a reverse linefeed (sr) at the top of the window
  52. moves all the text in the area down a line.  MG does not properly
  53. handle "cs" if your terminal needs control characters as paramaters,
  54. and in this case "cs" should not be defined.
  55.  
  56. If the cs and sr capabilities are available, the termcap driver uses
  57. these to make the insert/delete line functions work more smoothly. If
  58. only the cs capability is present, it is still used for the delete
  59. line function, but not for inserting lines.
  60.  
  61. Use of the cs capability is often desirable, but is not a win on
  62. bit-mapped screens such as Sun workstation console windows.  This is
  63. because it takes longer to scroll the window than to redraw it.  If
  64. you are using a workstation window, you might consider using a termcap
  65. entry that doesn't have the cs capability.
  66.  
  67. The definition of the cs capability is: the first parameter in the
  68. sequence defines the first row (origin 0) that is in the scrolling
  69. region, and the second argument defines the last row to include in the
  70. scrolling region.
  71.  
  72.     cs    -- set scrolling region (arg1 = top, arg2 = bottom)
  73.     sr    -- reverse index
  74.  
  75. The following capabilities provide for an enhanced (reverse-video or
  76. otherwise rendered) mode line.  The sg entry should not be present on
  77. terminals that do this to characters as they are placed on the screen.
  78. Terminals that put a region of the screen in the standout mode should
  79. have sg defined as numeric: :sg#0: for terminals that do this on
  80. regions but don't take any character positions to do this, (this may
  81. be a non-standard interprition of the meaning of sg) and the number of
  82. character positions taken by any other terminal.
  83.  
  84.     so    -- enter standout mode
  85.     se    -- leave standout mode
  86.     sg    -- number of character positions used by standout
  87.  
  88.         Terminal-specific initialization file
  89.  
  90. If the MG termcap terminal driver is compiled with XKEYS defined, and
  91. the startup file option is enabled as well, MG will look for a
  92. terminal-specific initialization file.  The name of the terminal
  93. initialization file varies between operating systems, but will usually
  94. look like .mg-TERM, where TERM represents your terminal type.  For
  95. example, a terminal initialization file under Unix and VMS for the DEC
  96. VT100 terminal (termcap type vt100) would have the name ".mg-vt100". 
  97.  
  98. The terminal-specific startup file has the same format as the mg
  99. startup file, and is executed immediately after the startup file
  100. during mg's startup phase.  An example vt100 initialization file
  101. follows, which globally binds the key sequences sent by the VT100
  102. terminal (in keypad mode) to the appropriate functions.
  103.  
  104. ----------------------------------CUT HERE-----------------------------------
  105. ;
  106. ; Small key definition file for VT100 terminals using the termcap
  107. ; driver. This only works if XKEYS is defined during compilation.
  108. ;
  109. (global-set-key "\eOA" 'previous-line)    ; up arrow
  110. (global-set-key "\eOB" 'next-line)    ; down arrow
  111. (global-set-key "\eOC" 'forward-char)    ; right arrow
  112. (global-set-key "\eOD" 'backward-char)    ; left arrow
  113.